3D Graphics Programming with QuickDraw 3D 1.5.4

Determining Point Affine Combinations

QuickDraw 3D provides routines that you can use to determine a point that is the affine combination of some given points.

Q3Point2D_AffineComb

You can use the Q3Point2D_AffineComb function to determine the two-dimensional point that is the affine combination of an array of points.



 
TQ3Point2D *Q3Point2D_AffineComb (

                     const TQ3Point2D *points2D, 

                     const float *weights, 

                     unsigned long nPoints, 

                     TQ3Point2D *result);

points2D: A pointer to an array of two-dimensional points.
weights: A pointer to an array of weights. The sum of the weights must be 1.0.
nPoints: The number of points in the points2D array.
result: On exit, the point that is the affine combination of the points in points2D having the weights in the weights array.

DESCRIPTION

The Q3Point2D_AffineComb function returns, as its function result and in the result parameter, the point that is the affine combination of the points in the array points2D having the weights in the array weights .

Q3Param2D_AffineComb

You can use the Q3Param2D_AffineComb function to determine the two-dimensional parametric point that is the affine combination of an array of parametric points.



 
TQ3Param2D *Q3Param2D_AffineComb (

                     const TQ3Param2D *params2D, 

                     const float *weights, 

                     unsigned long nPoints, 

                     TQ3Param2D *result);

params2D: A pointer to an array of two-dimensional parametric points.
weights: A pointer to an array of weights. The sum of the weights must be 1.0.
nPoints: The number of points in the params2D array.
result: On exit, the parametric point that is the affine combination of the parametric points in params2D having the weights in the weights array.

DESCRIPTION

The Q3Param2D_AffineComb function returns, as its function result and in the result parameter, the parametric point that is the affine combination of the parametric points in the array params2D having the weights in the array weights .

Q3Point3D_AffineComb

You can use the Q3Point3D_AffineComb function to determine the three-dimensional point that is the affine combination of an array of points.



 
TQ3Point3D *Q3Point3D_AffineComb (

                     const TQ3Point3D *points3D, 

                     const float *weights, 

                     unsigned long nPoints, 

                     TQ3Point3D *result);

points3D: A pointer to an array of three-dimensional points.
weights: A pointer to an array of weights. The sum of the weights must be 1.0.
nPoints: The number of points in the points3D array.
result: On exit, the point that is the affine combination of the points in points3D having the weights in the weights array.

DESCRIPTION

The Q3Point3D_AffineComb function returns, as its function result and in the result parameter, the point that is the affine combination of the points in the array points3D having the weights in the array weights .

Q3RationalPoint3D_AffineComb

You can use the Q3RationalPoint3D_AffineComb function to determine the rational three-dimensional point that is the affine combination of an array of points.



 
TQ3RationalPoint3D *Q3RationalPoint3D_AffineComb (

                     const TQ3RationalPoint3D *points3D, 

                     const float *weights, 

                     unsigned long nPoints, 

                     TQ3RationalPoint3D *result);

points3D: A pointer to an array of rational three-dimensional points.
weights: A pointer to an array of weights. The sum of the weights must be 1.0.
nPoints: The number of points in the points3D array.
result: On exit, the point that is the affine combination of the points in points3D having the weights in the weights array.

DESCRIPTION

The Q3RationalPoint3D_AffineComb function returns, as its function result and in the result parameter, the rational point that is the affine combination of the points in the array points3D having the weights in the array weights .

Q3RationalPoint4D_AffineComb

You can use the Q3RationalPoint4D_AffineComb function to determine the rational four-dimensional point that is the affine combination of an array of points.



 
TQ3RationalPoint4D *Q3RationalPoint4D_AffineComb (

                     const TQ3RationalPoint4D *points4D, 

                     const float *weights, 

                     unsigned long nPoints, 

                     TQ3RationalPoint4D *result);

points4D: A pointer to an array of rational four-dimensional points.
weights: A pointer to an array of weights. The weights must sum to 1.0.
nPoints: The number of points in the points4D array.
result: On exit, the point that is the affine combination of the points in points4D which have the weights in the weights array.

DESCRIPTION

The Q3RationalPoint4D_AffineComb function returns, as its function result and in the result parameter, the rational point that is the affine combination of the points in the array points4D which have the weights in the array weights .